home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / sysmips.z / sysmips
Encoding:
Text File  |  2002-10-03  |  7.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. SSSSYYYYSSSSMMMMIIIIPPPPSSSS((((2222))))                                                          SSSSYYYYSSSSMMMMIIIIPPPPSSSS((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sysmips - MIPS Computer Systems Inc. system call
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssyyyyssssmmmmiiiippppssss....hhhh>>>>
  13.  
  14.      iiiinnnntttt ssssyyyyssssmmmmiiiippppssss ((((iiiinnnntttt ccccmmmmdddd,,,, iiiinnnntttt aaaarrrrgggg1111,,,, iiiinnnntttt aaaarrrrgggg2222,,,, iiiinnnntttt aaaarrrrgggg3333))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _s_y_s_m_i_p_s is the interface to various machine specific functions.  The _c_m_d
  18.      argument determines the function performed.  The number of arguments
  19.      expected is dependent on the function.
  20.  
  21.      SSSSEEEETTTTNNNNAAAAMMMMEEEE
  22.           This function renames the system, which is sometimes referred to as
  23.           the node name or host name.  A single argument of type char * is
  24.           expected.  This points to a string that has a length less or equal
  25.           to MAXHOSTNAMELEN characters (defined in param.h).
  26.  
  27.      Note that this function is obsolescent. Instead, _uuuu_nnnn_aaaa_mmmm_eeee(2) should be used.
  28.  
  29.      SSSSTTTTIIIIMMMMEEEE
  30.           This function sets the system time and date.  The single argument is
  31.           of type long and contains the time as measured in seconds from
  32.           00:00:00 GMT January 1, 1970.  It does not affect the hardware
  33.           battery backed up time-of-day clock.  Note that this command is only
  34.           available to the super-user.
  35.  
  36.      FFFFLLLLUUUUSSSSHHHH____CCCCAAAACCCCHHHHEEEE
  37.           This function flushes both the instruction and data caches.  On
  38.           multiprocessor systems, all caches on all processors are flushed.
  39.           For finer control, use _c_a_c_h_e_f_l_u_s_h(2).  No arguments are expected.
  40.  
  41.      SSSSMMMMIIIIPPPPSSSSSSSSWWWWPPPPIIII
  42.           Add to, delete from, or determine the currently active swap areas.
  43.           The address of an appropriately primed swap buffer is passed as the
  44.           only argument.  (This buffer is displayed below and defined in the
  45.           ssssyyyyssss////sssswwwwaaaapppp....hhhh header file; refer to this file for details of loading
  46.           the buffer.)
  47.  
  48.           The format of the swap buffer is:
  49.  
  50.           struct swapinf {
  51.                char *si_cmd;       /* command: list, add, delete */
  52.                char *si_buf;       /* swap file path pointer */
  53.                int   si_swplo;          /* start block */
  54.                int   si_nblks;          /* swap size */
  55.           }
  56.  
  57.           Note that the add and delete options of the command may only be
  58.           exercised by the super-user.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSYYYYSSSSMMMMIIIIPPPPSSSS((((2222))))                                                          SSSSYYYYSSSSMMMMIIIIPPPPSSSS((((2222))))
  71.  
  72.  
  73.  
  74.      MMMMIIIIPPPPSSSS____FFFFIIIIXXXXAAAADDDDEEEE
  75.           This function enables or disables the transparent recovery from
  76.           unaligned address exceptions for the current process.  If _a_r_g_1 is 1,
  77.           recovery is enabled. If _a_r_g_1 is 0, recovery is disabled.  For
  78.           example, a halfword data access on an odd byte boundary would
  79.           ordinarily generate a SSSSIIIIGGGGBBBBUUUUSSSS signal to the user.  After calling this
  80.           function with _a_r_g_1 set to 1, the operating system will attempt to
  81.           allow the access to complete by retrying the access using byte-wise
  82.           instructions.
  83.  
  84.      MMMMIIIIPPPPSSSS____FFFFPPPPSSSSIIIIGGGGIIIINNNNTTTTRRRR
  85.           This function permits the caller to decide what happens when a
  86.           floating point operation requires operating system intervention.  If
  87.           _a_r_g_1 is 0, then these floating point operations are silently
  88.           executed by the operating system.  If _a_r_g_1 is a 1, then a SSSSIIIIGGGGFFFFPPPPEEEE
  89.           signal is generated before the operation is handled.  The process's
  90.           SSSSIIIIGGGGFFFFPPPPEEEE signal handler may then determine exactly what caused the
  91.           floating point hardware to require software intervention.  The
  92.           operating system, before sending the signal, will change the value
  93.           from a 1 to a 2 which means the next time an operation requires
  94.           operating system assistance, the SSSSIIIIGGGGFFFFPPPPEEEE will not be generated,
  95.           rather the value will be set back to a 1, and the operation will be
  96.           performed.  All other values for _a_r_g_1 are ignored.  This action is
  97.           cleared on _e_x_e_c(2) and inherited on _f_o_r_k(2) and _s_p_r_o_c(_2).  A more
  98.           complete exception handling package may be found in
  99.           _h_a_n_d_l_e__s_i_g_f_p_e_s(3C).
  100.  
  101.      When _c_m_d is invalid, _e_r_r_n_o is set to EINVAL on return.
  102.  
  103.      In addition, the _c_m_d SETNAME may also return:
  104.  
  105.      [EFAULT]       The argument points to an invalid address.
  106.  
  107.      The _c_m_d SMIPSSWPI may also return:
  108.  
  109.      [EFAULT]       _S_w_a_p_b_u_f points to an invalid address.
  110.  
  111.      [EFAULT]       _S_w_a_p_b_u_f._s_i__b_u_f points to an invalid address.
  112.  
  113.      [ENOTBLK]      Swap area specified is not a block special device.
  114.  
  115.      [EEXIST]       Swap area specified has already been added.
  116.  
  117.      [ENOSPC]       Too many swap areas in use (if adding).
  118.  
  119.      [ENOMEM]       Tried to delete last remaining swap area.
  120.  
  121.      [ENOMEM]       No place to put swapped pages when deleting a swap area.
  122.  
  123.      [EINVAL]       Bad arguments.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSYYYYSSSSMMMMIIIIPPPPSSSS((((2222))))                                                          SSSSYYYYSSSSMMMMIIIIPPPPSSSS((((2222))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      _cccc_aaaa_cccc_hhhh_eeee_cccc_tttt_llll(2), _cccc_aaaa_cccc_hhhh_eeee_ffff_llll_uuuu_ssss_hhhh(2), _ssss_eeee_tttt_hhhh_oooo_ssss_tttt_nnnn_aaaa_mmmm_eeee(2), _ssss_iiii_gggg_nnnn_aaaa_llll_((((2), _ssss_tttt_iiii_mmmm_eeee(2),
  142.      _uuuu_nnnn_aaaa_mmmm_eeee(2), _hhhh_aaaa_nnnn_dddd_llll_eeee______ssss_iiii_gggg_ffff_pppp_eeee_ssss(3C), _ssss_wwww_aaaa_pppp(1M).
  143.  
  144. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  145.      Upon successful completion, the value returned is zero.  Otherwise, a
  146.      value of -1 is returned and _e_r_r_n_o is set to indicate the error.
  147.  
  148. BBBBUUUUGGGGSSSS
  149.      The command code MMMMIIIIPPPPSSSS____FFFFPPPPUUUU is defined in _s_y_s/_s_y_s_m_i_p_s._h but is not
  150.      implemented.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.